home *** CD-ROM | disk | FTP | other *** search
/ Shareware Grab Bag / Shareware Grab Bag.iso / 013 / sdir411.arc / SDIR411.DOC < prev   
Encoding:
Text File  |  1984-11-28  |  7.5 KB  |  179 lines
  1. PROGRAM: SDIR411.COM
  2.  
  3. GENERAL FUNCTION: To give sorted directory of files on a disk.
  4.  
  5. WHY IS IT NEEDED?  DOS has no convenient or powerful way to order
  6. a list of files on a disk drive.
  7.  
  8. INSTALLATION: Probably will want to rename it SD.COM.
  9.  
  10. FORMAT:                 SDIR411  [d:][\path][filespec][/options]
  11.  
  12. EXAMPLES:               sdir411 a:/s
  13.  
  14. HOW TO USE IT:  This sorted directory has three major features compared
  15. to other sorted directory programs.  (1) Extremely fast screen
  16. I/O.  It pops the list on the screen rather than filling it slowly
  17. line by line.  Consequently, it always clears away the previous screen.
  18. (2) Scroll forward and back using PgUp and PgDn keys.  (3) It will create
  19. an commentable file of the list of files.  To exit back to DOS, press
  20. <esc> key.
  21.      The file of comments is an especially interesting option.  Whenever
  22. the "/C" option is used, the program looks for the file SDIR.$$$ and 
  23. will match the comments to the current files on the directory so that
  24. to comments are merged to the file list.  In effect, the comments are
  25. a data base that can be invoked anytime.  The data base file is a 
  26. standard ASCII file that can be edited.  Sysops running RBBS can use the
  27. "/C" option to produce directory lists (DIR files).     
  28.      See full docmentation for details.
  29.  
  30. OTHER EFFECTS: None
  31.  
  32. SYSTEM REQUIREMENTS:  Works with DOS 2.x and 3.0.
  33.  
  34. COMMENTS:  Documentation that follows is that provided by author for
  35. earlier version 4.0, clarified slightly.
  36.  
  37. SOURCE OF PROGRAM: Larry Hatt.
  38.  
  39.     TITLE   SDIR - SORTED DIRECTORY COMMAND, Version 4.0
  40.  
  41.                 REQUIRED CONFIGURATION
  42.  
  43.     * IBM PC or close clone
  44.     * Color Graphic or IBM Mono screen adapter
  45.     * DOS 2.0 or 2.1
  46.     * 80 bytes of disk storage on the current directory
  47.           for each file with a comment.    
  48.  
  49.                  USING SDIR VERSION 4.0
  50.  
  51.     SDIR [d:][path][filename[.ext]] [options]                      
  52.      [filespec] same as for DIR command
  53.  
  54.      [options]   /A - List hidden files and attributes.
  55.                  /C - Single Column Commented Directory.            
  56.                  /X - Sort by extension.
  57.                  /S - Sort by size.
  58.                  /D - Sort by date/time.
  59.                  /N - Do not sort, original order.
  60.  
  61.        Default = *.* sorted by name.ext with screen erase.
  62.              - Non conflicting Options may be combined. 
  63.  
  64.     /C  - The directory is listed in one column only; use PgUp/
  65.     PgDn to page through any number of pages.  A file SDIR.$$$
  66.     is  either  created  or opened  and sorted with comments
  67.     appearing beside the appropriate file.  The real directory is
  68.     of course not touched; in fact although each whole file line
  69.     is stored, only the last 40 characters are written to the 
  70.     screen.  Thus, progressive updates of the same file will keep
  71.     the same comments.  The comments for deleted files will auto-
  72.     matically be deleted.  Only lines with non-blank comments will
  73.         be written.  Every time this option is invoked, SDIR.$$$ will
  74.         be overwritten.
  75.  
  76.     Edit control is available to write new comments:
  77.                 - normal upper and lower case characters
  78.                 - RTN: jump to beginning of next line
  79.                 - DEL and BKSP: distructive cursor left
  80.                 - Typeover correction
  81.                 - CURSOR: control keys work normally
  82.                 - PgUp and PgDn: normal
  83.  
  84.     /A  - The column 'ATR' (displayed after the file date/time)
  85.     gives up to 4 attribute codes as follows:
  86.                 
  87.                 A - Archive bit is off (file has been archived)
  88.                 D - Directory entry
  89.                 H - Hidden bit is on (file is hidden)
  90.                 R - Read-only bit is on (file is read-only)
  91.                 S - System bit is on (file is a system file)
  92.  
  93.     ESC: must use this key to return to DOS .
  94.  
  95.     HINT: for faster operation change name of file to SD.COM
  96.  
  97.     NOTE: Although SDIR40.COM has been extensively tested with both
  98.     floppies A: and B: and a 10 MB HDisk both with standard and 
  99.     and multi-level sub-directories without problems, it must be con-
  100.     sidered a BETA version.  I would appreciate hearing of any problem
  101.     and in particular with MONO screen experience.  A developmental
  102.     version was tested on a system with the Hercules Mono card with no
  103.     problems but this has not been retested recently.
  104.  
  105.     BUG WARNING: Do not delete the small box in front of the "bytes 
  106.     remaining" in the /C mode.  If you do your comments will be destroyed
  107.     and the system will hang on exit.  Screen editing beyond the range of
  108.     the directory is not recommended and will be inhibited in future
  109.     versions.
  110.  
  111.     Direct comments or problems to:             Larry Hatt PC1269.
  112.                                              76 Melville Dr
  113.                                              Nepean, Ont, K2J2E1
  114.  
  115.  
  116.             DEVELOPMENT OF SDIR
  117.  
  118.  
  119.  
  120. ORIGINAL. The original file is from an object file named
  121. SD.HEX from Gene Plantz's BBS in Chicago.  John Chapman is
  122. thought to be the author.  It was  dis-assembled and com-
  123. mented by Ted Reuss of Huston, TX.  Several modifications 
  124. were made by Ted: 
  125.         1. Filespecs  processed as for DIR 
  126.         2. No sort option was added. /N
  127.         3. Number of files found is printed.
  128.  
  129. VER 2.2. The GETFREE Subroutine was updated for DOS 2.0
  130. April 1, 1983 by Jack Y. Fong.  His changes are denoted by "JYF"
  131. at the end of changed lines.
  132.  
  133. VER 2.3.  Added display of current directory name and
  134. volume name in header lines for DOS Release 2.0.  Added total
  135. of file sizes for the displayed files.  These change were made
  136. by  John F. Ratti   29 June, 1983 and are denoted by "2.3" at
  137. the end of the changed lines.
  138.  
  139. VER 2.4. Display of attribute byte was added. The column 'ATR'
  140. (displayed after the file date/time) gives up to 5 attribute
  141. codes as follows:
  142.                 A - Archive bit is off (file has been archived)
  143.                 D - Directory entry
  144.                 H - Hidden bit is on (file is hidden)
  145.                 R - Read-only bit is on (file is read-only)
  146.                 S - System bit is on (file is a system file)
  147. Corrected display of hidden, system, attribute  and  read-only
  148. entries when /a option is specified.  Added pathname capability.
  149. Any pathname that DIR will accept works.  This version MUST be
  150. used under MS-DOS release 2.0.  These changes were made by
  151. John F. Ratti   03 July, 1983 and are denoted by "2.4" .
  152.  
  153. VER 3.0. A 4-column display is available and more display option
  154. for subdirectories.  Authored by W.C. Bodycomb; the changes in
  155. this version are not incorporated in Version 4.0.
  156.  
  157. VER 4.0. The display was speeded up and made more flexible with
  158. the implementation of direct screen access (both CG and MONO).
  159. PgUp and PgDn control paging and ESC returns to DOS.  The
  160. COMMENTED DIRECTORY  option was added (/C).  This places the
  161. directory in single column mode leaving the right side of the
  162. screen for comments up to 40 characters long.  The cursor control
  163. keys are used for positioning;  BKSP, DEL and RTN function along
  164. with page control.  The program creates/uses a file called
  165. SDIR.$$$ on each disk/directory to store comments.  Only lines with
  166. some (any) info written beside files are stored.   Existing com-
  167. ments are automatically loaded if the /C is used on the command
  168. line and these can be edited or new ones added as desired.
  169. Uncommented files do not add to storage in SDIR.$$$
  170.  
  171. Version 4.0 changes were made by Larry Hatt, Nepean, Ont
  172. June/July 1984.
  173.  
  174. Downloaded from PCBBS-Chicago (Sysop-Gene Plantz) August 11, 1983
  175. Uploaded to PCanada by Mark Magner (PC296)        August 11, 1983
  176. Uploaded Ver 4.0 to PCanada by Larry Hatt (PC1269)August  8, 1984 
  177.  
  178. Direct comments or problems to Larry Hatt PC1269.